home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / usenet / sources / volume90 / unix / du_1_4 / part01 / du.doc < prev    next >
Text File  |  1990-10-08  |  3KB  |  110 lines
  1. DU 1.4            AMIGA            DU 1.4
  2.  
  3. NAME
  4.     du -- print out disc usage
  5.  
  6. SYNOPSIS
  7.     du [ -s | -v ] [ -S | -F | -T] [ filename ]
  8.  
  9. DESCRIPTION
  10.  
  11.     du prints out a summary of  disc usage for a
  12.     file or directory.  It is pure, and thus can
  13.     be  made resident.  It   takes up only  1640
  14.     bytes.
  15.  
  16.     
  17.     The options to du are:
  18.  
  19.     -v  verbose  listing.  du usually prints out
  20.         only total directory contents.  With the
  21.         -v     option, du prints out the block size
  22.         of every file.
  23.  
  24.     -s  short  listing.   Print  only  the total 
  25.         number of blocks used.
  26.  
  27.     -S  Calculate the number of blocks  used  as
  28.         if    by   the   old (Slow) 488 byte-block
  29.         file system.
  30.  
  31.     -F  Calculate the number of blocks  used  as
  32.         if by the new (Fast) 512 byte-block file
  33.         system.
  34.  
  35.     -T  Calculate  the  number  of  blocks  that
  36.         would be used  by  a  POSIX  tar  format
  37.         archive. Note  that when this  option is
  38.         used,  the resulting  file size will  be
  39.         greater than  the  option  given, except
  40.         when made on a raw device such  as RDF:.
  41.         Moreover, most  tar archivers  round the
  42.         size of  the output   file   up   to the
  43.         nearest block boundary (often 10k).
  44.  
  45.     Using the -S and  -F options, one can easily
  46.     work  out whether a directory will  fit when
  47.     moved between floppy and hard disc.  Without
  48.     either   option, du   interrogates  the file
  49.     system to work out the blocksize.
  50.  
  51. CAVEATS      
  52.  
  53.     du correctly  accounts for  directory blocks
  54.     and file  list blocks on current versions of
  55.     AmigaDOS   file    systems.   It will   work
  56.     incorectly  on MS-DOS volumes   mounted  via
  57.     msh: or crossdos.
  58.  
  59. AUTHOR
  60.     Peter Chubb
  61.     peterc@softway.sw.oz.au
  62.     (... !uunet!munnari!softway.sw.oz!peterc)
  63.  
  64. CHANGES
  65.     Version 1.2: First released version.
  66.  
  67.     Version 1.3: Fixed   bug   when  calculating
  68.                  blocksize  for moderately large
  69.                  files,   and  an off-by-one bug
  70.              for small files.
  71.  
  72.     Version 1.4: Moved  info  about  files  into
  73.              separate  table, to allow  easy
  74.              extension to new filesystems.
  75.              (It's still not flexible enough, 
  76.              though).
  77.  
  78.  
  79. DISTRIBUTION
  80.  
  81.     Copyright 1990 Peter Chubb  
  82.     All rights reserved.
  83.  
  84.     This    program       and  its    associated
  85.     documentation  may not  be   distributed for
  86.     profit.  It may be distributed provided
  87.     
  88.     a) no charge is made other than for 
  89. reasonable copying and media expenses,
  90.  
  91.     b) no   change  is   made to   the   source,
  92.     documentation or binary, that is not clearly
  93.     marked as being a change, and
  94.  
  95.     c) all files  are provided.  These comprise:
  96.         du.doc  -- this documentation file
  97.         du    -- the program binary (or
  98.                du.uu, its uuencoded form)
  99.         du.c    -- the program source.
  100.  
  101.  
  102.     This  program     is   not   warranted,   or
  103.     guaranteed.  You  get  exactly what you paid
  104.     for --  a copy of  the program  to do as you
  105.     wish with.   If  it crashes  your   machine,
  106.     writes  rude letters    to  your spouse,  or
  107.     explodes in your  face ...   caveat  emptor!
  108.     However, to the   best of   my knowledge and
  109.     belief it works as advertised.
  110.